home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / business / vndvue10.zip / VENDVIEW.DOC < prev    next >
Text File  |  1994-07-21  |  34KB  |  944 lines
  1.  
  2.     
  3.  
  4.  
  5.  
  6.  
  7.                   +----------------------------------------+
  8.                   |                                        |
  9.                   |                                        |
  10.                   |              User's Guide              |
  11.                   |                                        |
  12.                   |          VendView(TM) Viewer           |
  13.                   |   for displaying VENDINFO.DIZ files    |
  14.                   |              Version 1.00              |
  15.                   |                                        |
  16.                   |                                        |
  17.                   |        Last updated: July 1994         |
  18.                   |                                        |
  19.                   |                                        |
  20.                   |  Copyright 1994 Rams' Island Software  |
  21.                   |          All rights reserved           |
  22.                   |                                        |
  23.                   +----------------------------------------+
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.    Rams' Island Software
  45.    7644 E. Lakecliff Way                   _______
  46.    Parker, CO 80134-5904 (USA)        ____|__     |                (R)
  47.                                    --|       |    |-------------------
  48.    Voice: (303) 841-2848             |   ____|__  |  Association of
  49.    BBS:   (303) 841-6269             |  |       |_|  Shareware
  50.    CompuServe: 76244,324             |__|   o   |    Professionals
  51.                                    -----|   |   |---------------------
  52.    FidoNet:  1:104/333                  |___|___|    MEMBER
  53.    RIME:     1235
  54.    Internet: 76244.324@compuserve.com
  55.  
  56.  
  57.                                                                            
  58.  
  59.  
  60.  
  61.  
  62.    VendView User's Guide                                  Table of Contents
  63.  
  64.  
  65.                              +-------------------+
  66.                              | Table of Contents |
  67.                              +-------------------+
  68.  
  69.  
  70.     The VENDINFO System ................................................  1
  71.        Components of the System ........................................  1
  72.        Structure of a VENDINFO File ....................................  2
  73.        A Little Background .............................................  3
  74.        Industry Support and Endorsements ...............................  4
  75.        Other VENDINFO Documents and Packages ...........................  5
  76.  
  77.     Installation .......................................................  7
  78.        Quick Start .....................................................  7
  79.        Detailed Contents of the VendView Package .......................  8
  80.        Warranty and License ............................................  9
  81.        Technical Support for VendView ..................................  9
  82.  
  83.     VendView: A User's Viewer for VENDINFO Files ....................... 11
  84.        Use of VendView Simply to View VENDINFO Files ................... 11
  85.        Use of VendView to Test Package Integrity ....................... 12
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.    VendView Viewer v1.00             -ii-                         July 1994
  117.  
  118.  
  119.  
  120.  
  121.  
  122.    VendView User's Guide                                           VendView
  123.  
  124.  
  125.                               +-----------------+
  126.                               | Acknowledgments |
  127.                               +-----------------+
  128.  
  129.    Many people have helped to mold the VENDINFO vision, and to provide
  130.    support and encouragement throughout its development process. Thanks are
  131.    given to all those who have reviewed the Concept Paper or the VENDINFO
  132.    standard, or who have otherwise made suggestions regarding the project.
  133.  
  134.    The author is especially grateful to Fred Hill and Richard Holler, for
  135.    long-term support and help with VENDINFO.
  136.  
  137.    While many have reviewed parts of the VENDINFO documentation, special
  138.    thanks go to Jim Green, for helping us avoid a wrong direction; to Bob
  139.    Ostrander for a simple but particularly powerful idea; and to Daan van
  140.    Rooijen, for really studying the standard and providing many, many
  141.    useful suggestions.
  142.  
  143.    Many people have also helped in beta testing the VENDINFO tools, and
  144.    we're grateful to them all. Special thanks are given to Steve Estvanik
  145.    and Jerry Stern, for really giving things a workout, and tirelessly
  146.    reporting the results.
  147.  
  148.    The VENDINFO team is grateful to the following shareware trade associa-
  149.    tions for their endorsements of VENDINFO:
  150.  
  151.       Association of Shareware Professionals (ASP)
  152.       Association of Shareware Authors and Distributors (ASAD)
  153.       Shareware Trade Association and Resources (STAR)
  154.       Educational Software CoOperative (ESC)
  155.  
  156.    Finally, we particularly appreciate the 30-or-so software development
  157.    teams (mostly BBS-related) whose early commitment to support the
  158.    VENDINFO standard in their software products has helped provide momentum
  159.    and visibility to this effort.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.    VENDINFO, VendEdit, VendPrcs, VendView, and VendLib are trademarks of
  172.    Rams' Island Software.
  173.  
  174.  
  175.  
  176.    VendView Viewer v1.00             -iii-                        July 1994
  177.  
  178.  
  179.  
  180.  
  181.    VendView User's Guide                           Introduction to VENDINFO
  182.  
  183.  
  184.     
  185.                             +---------------------+
  186.                             | The VENDINFO System |
  187.                             +---------------------+
  188.  
  189.       VENDINFO is a system for conveying software product information and
  190.       distribution permissions from the author to distributors and users. A
  191.       standard (public) file format allows a VENDINFO.DIZ file to carry
  192.       extensive information in a compressed, efficient form. The associated
  193.       toolset:
  194.  
  195.            o  aids the author in constructing the record
  196.  
  197.            o  allows the distributor to extract portions of the record, or
  198.               to make distribution decisions based on its content, in a
  199.               highly automated way
  200.  
  201.            o  allows the user to view user-relevant product information
  202.               quite easily.
  203.  
  204.  
  205.       VENDINFO provides unprecedented capabilities for
  206.  
  207.            o  Communication of product information and distribution
  208.               policies from authors to users and distributors.
  209.  
  210.            o  Automation of many aspects of package handling by shareware
  211.               distributors of all types.
  212.  
  213.  
  214.  
  215.    Components of the System
  216.    ------------------------
  217.  
  218.       The VENDINFO "record" is the key. This is an efficiently compressed
  219.       file (VENDINFO.DIZ) containing a great deal of information about the
  220.       product, the author, and the product's distribution policies.
  221.  
  222.       The VendEdit editor allows the author to construct a complete
  223.       VENDINFO record in just a few minutes, assuming that the necessary
  224.       descriptive texts have already been prepared.
  225.  
  226.       The VendPrcs (pronounced "vend process") processor is a batch program
  227.       allowing automated decisions based on VENDINFO content, and automated
  228.       extraction of VENDINFO information.
  229.  
  230.       VendView is a simple menu-driven viewer that allows the end-user to
  231.       se relevant portions of the VENDINFO data. Even without VendView, an
  232.       ordinary text viewer will display a good deal of useful information.
  233.  
  234.  
  235.    VendView Viewer v1.00              -1-                         July 1994
  236.  
  237.  
  238.  
  239.  
  240.    VendView User's Guide                           Introduction to VENDINFO
  241.  
  242.  
  243.       The Product Registry is a collection of VENDINFO records available
  244.       for searches and queries by subscription, BBS login, or mail-order
  245.       query.
  246.  
  247.       The VendLib Library allows software developers to build VENDINFO
  248.       access directly into such products as BBS programs and upload proces-
  249.       sors. This library is already in the hands of some 30 vendors of
  250.       BBSes, BBS utility software, and other relevant software.
  251.  
  252.       The file-format standard describing the VENDINFO file is public, and
  253.       draft versions have been published since July 1993. The final version
  254.       1.00 has been released, and is the basis for the current toolset.
  255.  
  256.       VendPrcs Plus, a non-shareware version of VendPrcs, is planned for
  257.       release by late Summer 1994. It will have a full-screen interface,
  258.       using scripts for easier, more efficient information extraction, and
  259.       templates for easier description of decision situations. It will also
  260.       allow management of a library of VENDINFO files, and will provide
  261.       automated access to the Product Registry BBS.
  262.  
  263.       Additional services for authors, users, and distributors are under
  264.       consideration.
  265.  
  266.  
  267.    Structure of a VENDINFO File
  268.    ----------------------------
  269.  
  270.       The VENDINFO.DIZ file contains two sections. A human-readable front
  271.       section contains information about how to use the VENDINFO file, and
  272.       presents most of the basic information about the product in readable
  273.       form.
  274.  
  275.       The second section is a binary data record, compressed with a PKZIP
  276.       1.10 algorithm, and appended to the file after the first section.
  277.       This record has some 750 fields of information about such things as
  278.  
  279.            o  Product name, date, and version
  280.  
  281.            o  Preferred package filename, other parts of product, replaced
  282.               versions
  283.  
  284.            o  Product descriptions of varying length, categories, keywords
  285.  
  286.            o  Required platform (CPU, operating system, memory, disk,
  287.               features)
  288.  
  289.            o  Contact information for author, for registering, for tech
  290.               support
  291.  
  292.  
  293.  
  294.    VendView Viewer v1.00              -2-                         July 1994
  295.  
  296.  
  297.  
  298.  
  299.    VendView User's Guide                           Introduction to VENDINFO
  300.  
  301.  
  302.            o  Registration prices and benefits, acceptable forms of payment
  303.  
  304.            o  Warranty and trial-use license
  305.  
  306.            o  Detailed distribution policy, in general and by distribution
  307.               channel
  308.  
  309.            o  Information about regional distributors and registration
  310.               services.
  311.  
  312.  
  313.  
  314.    A Little Background
  315.    -------------------
  316.  
  317.       The author of the VENDINFO standard and tools, Rudy Ramsey, has been
  318.       agitating since early 1992 for the development of an improved
  319.       mechanism for conveying product information and permissions from
  320.       authors to distributors. Initially, the intent was to make this a
  321.       purely volunteer-based effort, probably conducted within the auspices
  322.       of the Association of Shareware Professionals. However, others were
  323.       slow to respond to the idea (with the exception of Richard Holler and
  324.       Fred Hill), and it gradually became clear that it would have to be
  325.       done as an "extracurricular" effort, if at all.
  326.  
  327.       In the Spring of 1993, Rudy began the VENDINFO effort in earnest, by
  328.       preparing the CONCEPT.DOC concept paper and distributing it to a few
  329.       key shareware industry figures for comment. (At this time, he still
  330.       imagined VENDINFO as an all-volunteer effort.) The reviewers were
  331.       uniformly excited about the idea, and greatly encouraging. Most felt
  332.       that it was an idea whose time had come, and that the technical
  333.       approach described in the concept paper was very appropriate.
  334.  
  335.       Their second response, however, was that the effort contained the
  336.       seeds of its own failure. It might provide all the necessary incen-
  337.       tives for participation by authors, distributors, and users. But if
  338.       it didn't also provide an incentive for continued development and
  339.       support by its own development team, it would fail. It was simply too
  340.       big an activity for successful execution by volunteers.
  341.  
  342.       As a result of that input, a decision was made to regard VENDINFO as
  343.       partly a business opportunity. Although this makes a few people
  344.       suspicious, most agree it's in the best interest of the VENDINFO
  345.       effort itself, and of the industry. In fact, VENDINFO has developed
  346.       rapidly, partly because it has been a full-time focus of its author
  347.       for many months. That wouldn't have been possible in an all-volunteer
  348.       effort.
  349.  
  350.       The VENDINFO file-format standard is public. A substantial period was
  351.  
  352.  
  353.    VendView Viewer v1.00              -3-                         July 1994
  354.  
  355.  
  356.  
  357.  
  358.    VendView User's Guide                           Introduction to VENDINFO
  359.  
  360.  
  361.       provided for public comment on the concept paper, and then on the
  362.       standard, and public input is always welcome. Some of the tools that
  363.       make use of the standard are free (a viewer for end users, and the
  364.       processor when used by single-line, noncommercial BBSes). Most are
  365.       low-cost shareware. There will also be much-enhanced, non-shareware
  366.       programs later, for special purposes, but none of them are necessary
  367.       to achieve the benefits of the VENDINFO system.
  368.  
  369.  
  370.    Industry Support and Endorsements
  371.    ---------------------------------
  372.  
  373.       Support for the VENDINFO concept has been extraordinarily high
  374.       throughout the industry. Authors, disk vendors, CD-ROM publishers,
  375.       Sysops, and BBS software manufacturers have all expressed their
  376.       support, and many have pledged to build VENDINFO capability into
  377.       their own software products.
  378.  
  379.       The following shareware trade groups have formally endorsed the
  380.       VENDINFO file-format standard as a means of conveying product and
  381.       product-distribution information from authors to users and dis-
  382.       tributors.
  383.  
  384.          Association of Shareware Professionals (ASP)
  385.          Shareware Trade Association and Resources (STAR)
  386.          Association of Shareware Authors and Developers (ASAD)
  387.          Educational Software CoOperative (ESC)
  388.  
  389.       The ASP has licensed the VENDINFO toolset for use by all 1700 of its
  390.       members. This will greatly accelerate the use -- and the usefulness
  391.       -- of VENDINFO.
  392.  
  393.       The following software manufacturers have "committed in principle" to
  394.       support VENDINFO in their own software offerings by mid-1994. In the
  395.       context of these products, "support" for VENDINFO means extracting
  396.       relevant descriptive information automatically from VENDINFO files.
  397.       It does not necessarily mean making decisions based on the product's
  398.       distribution policy. VendPrcs will provide that capability.
  399.  
  400.          BBSes
  401.  
  402.             PCBoard, Clark Development Co.
  403.             Wildcat!, Mustang Software, Inc.
  404.             Major BBS, Galacticomm
  405.             RBBS, RBBS Development Team
  406.             Searchlight BBS, Searchlight Software
  407.             TBBS, eSoft
  408.             Auntie BBS, Wes Meier
  409.             Executive Host BBS, Steve Wood
  410.  
  411.  
  412.    VendView Viewer v1.00              -4-                         July 1994
  413.  
  414.  
  415.  
  416.  
  417.    VendView User's Guide                           Introduction to VENDINFO
  418.  
  419.  
  420.             MainLine BBS, Scott Green, City Limits Software
  421.             OmegaComm BBS, Larry Loiselle
  422.             PowerBBS for Windows, Russell Frey
  423.             ProBoard BBS, Philippe Leybaert
  424.             Sapphire BBS, Pinnacle Software
  425.             Tinyhost, Bruce Krobusek
  426.             UltraBBS, UltraBBS Software
  427.             Windowed Modem Environment, Jason Fesler
  428.  
  429.          File Upload Processors
  430.  
  431.             CatScan, Mike Ortiz
  432.             CheckZip, Bill Hull
  433.             DIZIT, Robert Neal/CorpSoft
  434.             HoboScan, Floyd Hobson
  435.           **TransScan, Craig Dunstan
  436.  
  437.          File Distribution Processors
  438.  
  439.             WCFF, Online Computer Resources
  440.  
  441.          Other Products
  442.  
  443.            *BBSee Disk Cataloger, Martin Vallevand
  444.           **Catalog-on-a-Disk, EmmaSoft Software Company, Inc.
  445.             Colorado Utilities Disk Manager, Micro Systems Solutions
  446.           **SmartCat Disk Cataloger, Oakley Data Services
  447.  
  448.        * Test versions are known to exist which support VENDINFO
  449.       ** Released products support VENDINFO
  450.  
  451.  
  452.    Other VENDINFO Documents and Packages
  453.    -------------------------------------
  454.  
  455.       The VENDINFO idea is documented in detail in a concept paper and in
  456.       the VENDINFO file-format standard. These two documents are available
  457.       in the VENDINFO information package, usually named VNDINFxx.ZIP
  458.       (where xx represents the version number).
  459.  
  460.       The basic VENDINFO Toolkit (for authors and distributors) is avail-
  461.       able in the VendTools package, usually named VNDNFOxx.ZIP. The
  462.       VendView viewer package, for end-users, is usually named
  463.       VNDVUExx.ZIP.
  464.  
  465.       All of these can be obtained from the Rams' Island BBS on first login
  466.       or by FidoNet or RIME file request. (FidoNet magic names for current
  467.       versions consist of just the alphabetic portion of the package
  468.       prefix, as VNDINF, VNDNFO, and VNDVUE.) They are also available in
  469.  
  470.  
  471.    VendView Viewer v1.00              -5-                         July 1994
  472.  
  473.  
  474.  
  475.  
  476.    VendView User's Guide                           Introduction to VENDINFO
  477.  
  478.  
  479.       the CompuServe SHAREWARE and UKSHARE forums; the ASP Hub Network
  480.       BBSes; many local BBSes around the world, including those associated
  481.       with the Software Distribution Network; from some disk vendors; and
  482.       on the ASP, JSC, and PsL CD-ROMs.
  483.  
  484.       If necessary, the concept paper and evaluation versions of the basic
  485.       toolset can be obtained on diskette from Rams' Island Software for
  486.       US$ 6.00 plus $2.00 shipping and handling in North America, $4.00
  487.       elsewhere. Payment is accepted by Visa/MasterCard, check in U.S.
  488.       dollars drawn on a U.S. bank, cash in any hard currency (registered
  489.       mail suggested), and various other forms. ing those associated with
  490.       the Software Distribution Network; from some disk vendors; and on the
  491.       ASP, JSC, and PsL CD-ROMs.
  492.  
  493.       If necessary, the concept paper and evaluation versions of the basic
  494.       toolset can be obtained on diskette from Rams' Island Software for
  495.       US$ 6.00 plus $2.00 shipping and handling in North America, $4.00
  496.       elsewhere.
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.    VendView Viewer v1.00              -6-                         July 1994
  531.  
  532.  
  533.  
  534.  
  535.    VendView User's Guide                                       Installation
  536.  
  537.  
  538.        
  539.                                +--------------+
  540.                                | Installation |
  541.                                +--------------+
  542.  
  543.       To install the VendView viewer, simply unzip or copy all files into a
  544.       single directory on your hard drive.
  545.  
  546.       For convenience, you may wish to place the directory on your DOS
  547.       PATH, probably via a PATH statement in your AUTOEXEC.BAT file. (Con-
  548.       sult your DOS manual if you're unfamiliar with this operation. If
  549.       you're using MS-DOS v5.0 or later, you can use the command "help
  550.       path" to learn more.)
  551.  
  552.       Many users keep their DOS PATH and directory structure simple, by
  553.       placing small utility programs in a single directory rather than
  554.       allocating a separate directory for each utility. If you wish to do
  555.       this, you can place these files:
  556.  
  557.          VENDVIEW.EXE (the program itself)
  558.          VENDVIEW.HLP (the program's help file)
  559.          CATEGORY.INF (a list of product categories used by VendView)
  560.  
  561.       into a directory that is already on your DOS PATH. It is inadvisable
  562.       to use the \DOS directory for this purpose, but you may find it
  563.       convenient to keep such programs in a directory that you create, such
  564.       as C:\TOOLS. These three files must be installed in the same direc-
  565.       tory, for proper operation of VendView.
  566.  
  567.       The remaining files can be retained or eliminated, as you prefer.
  568.       (You may wish to leave all files in the same directory until you've
  569.       become familiar with VendView.)
  570.  
  571.  
  572.    Quick Start
  573.    -----------
  574.  
  575.       To invoke VendView on a VENDINFO file, make sure the file is in the
  576.       current working directory, and execute the command
  577.  
  578.          vendview
  579.  
  580.       If you have not placed VENDVIEW.EXE in a directory that's on your DOS
  581.       path, You'll need to use the full pathname of that file, such as:
  582.  
  583.          c:\vendview\vendview.exe
  584.  
  585.       If you're executing VendView from a read-only medium, such as a CD-
  586.       ROM drive, you'll have to use the -d (directory) command-line flag,
  587.  
  588.  
  589.    VendView Viewer v1.00              -7-                         July 1994
  590.  
  591.  
  592.  
  593.  
  594.    VendView User's Guide                                       Installation
  595.  
  596.  
  597.       to assign a writeable directory in which VendView can create its
  598.       VENDVIEW.CFG configuration file. You might also need to do this if
  599.       you're using a version of MS-DOS earlier than 3.0. An example might
  600.       be:
  601.  
  602.          d:\files\vendview\vendview.exe -dc:\myconfig
  603.  
  604.       In most cases, software packages will have only one VENDINFO file, it
  605.       will have the standard filename VENDINFO.DIZ, and VendView will load
  606.       it automatically. If the current directory contains multiple VENDINFO
  607.       files, you can either load the preferred file after starting
  608.       VendView, or you can specify it by adding the filename to the command
  609.       line, as
  610.  
  611.          vendview INCXT11.DIZ
  612.  
  613.       For a really quick start, just invoke VendView in the directory in
  614.       which you've installed it. You'll have access to the help system,
  615.       which tells you everything you need to know to make use of VendView,
  616.       and you'll be able to practice by viewing the VENDINFO.DIZ file that
  617.       comes with VendView itself.
  618.  
  619.       The context-sensitive help system should provide you all the addi-
  620.       tional information you require. Just press F1 or Alt-H for help.
  621.       Pressing F1 twice, from anywhere, will display the help system index.
  622.  
  623.       It is suggested that you use the help information extensively at
  624.       first, and specifically that you read the first three items in the
  625.       index. These provide a quick introduction to the VENDINFO system in
  626.       general, and to the use of VendView in particular.
  627.  
  628.  
  629.    Detailed Contents of the VendView Package
  630.    -----------------------------------------
  631.  
  632.       The VendView package includes the following files:
  633.  
  634.          VENDVIEW.DOC   This document.
  635.  
  636.          VENDVIEW.EXE   The executable program for VendView.
  637.  
  638.          VENDVIEW.HLP   Help file used by VendView.
  639.  
  640.          CATEGORY.INF   Product category data file used by VendView.
  641.  
  642.          VENDINFO.DIZ   The VENDINFO.DIZ file that describes the VendView
  643.                         package itself. It's worth viewing both with a text
  644.                         viewer and with the assistance of the VendView
  645.                         program itself.
  646.  
  647.  
  648.    VendView Viewer v1.00              -8-                         July 1994
  649.  
  650.  
  651.  
  652.  
  653.    VendView User's Guide                                       Installation
  654.  
  655.  
  656.          REGISTER.FRM   Registration form for other tools and services
  657.                         associated with the VENDINFO system. No registra-
  658.                         tion is required to use VendView itself.
  659.  
  660.          FILE_ID.DIZ    A small file containing a description of this
  661.                         package, currently used by many BBS and BBS-utility
  662.                         programs to automatically load such descriptions
  663.                         into their files databases. VENDINFO will even-
  664.                         tually render this convention obsolete, but
  665.                         FILE_ID.DIZ files should continue to be used, for
  666.                         now.
  667.  
  668.          VENDOR.DOC     A small "stub" pointing the distributor to
  669.                         VENDINFO.DIZ for information.
  670.  
  671.          READ_ME.1ST    A small "stub" pointing the user to VENDINFO.DIZ
  672.                         for information.
  673.  
  674.  
  675.    Warranty and License
  676.    --------------------
  677.  
  678.       VendView is a "freeware" product. You are free to use it without
  679.       registration or payment. Individuals may also give copies of it to
  680.       others, provided no fee is charged and the the copy distributed is
  681.       complete and unaltered. For policies regarding other distribution and
  682.       package modification, see the Distribution License in the
  683.       VENDINFO.DIZ file.
  684.  
  685.       The Warranty and License governing your use of this product will be
  686.       found in the VENDINFO.DIZ file that accompanies this package. You can
  687.       view it using VendView itself, or view or print it with the tools you
  688.       use for ordinary text files.
  689.  
  690.  
  691.    Technical Support for VendView
  692.    ------------------------------
  693.  
  694.       If you have a problem with installation or use of this product, and
  695.       the documentation and help system don't provide the information you
  696.       need, we'll try to help. Please keep in mind, however, that this is a
  697.       free product, and there's a limit to the level of support we can
  698.       afford to provide for it. If possible, we would prefer to provide
  699.       help with this product via one of our public support forums (see
  700.       below), our product support BBS, or via some other electronic means.
  701.       If the need is great, however, or you just don't have access to the
  702.       other methods, you may use any of the contact methods indicated
  703.       below.
  704.  
  705.  
  706.  
  707.    VendView Viewer v1.00              -9-                         July 1994
  708.  
  709.  
  710.  
  711.  
  712.    VendView User's Guide                                       Installation
  713.  
  714.  
  715.       RAMS' ISLAND BBS
  716.  
  717.       The Rams' Island BBS is a bulletin board system, accessible to you if
  718.       if you have a modem and communication software. On our BBS, you will
  719.       always find the latest version of the program, and you will be able
  720.       to ask technical questions of us and of our other users. We also
  721.       offer additional utilities, class definitions, application notes, and
  722.       other assistance to registered users via the BBS. The BBS phone
  723.       number is 303-841-6269.
  724.  
  725.       COMPUSERVE INFORMATION SYSTEM
  726.  
  727.       We also support this product on the CompuServe information system.
  728.       The latest version of the program is always available there in the
  729.       SHAREWARE and UKSHARE forums, and technical questions and support
  730.       requests may be sent to us via electronic mail there or on the
  731.       CompuServe SHAREWARE and UKSHARE forums. Our CompuServe user ID is
  732.       76244,324.
  733.  
  734.       BBS NETWORK FORUMS
  735.  
  736.       We have established VENDINFO support forums on both the FidoNet and
  737.       RIME networks. We are investigating a VENDINFO forum on GlobalNet.
  738.  
  739.       OTHER ELECTRONIC ADDRESSES
  740.  
  741.       You can reach us through three other computer networks (you can
  742.       usually find a local BBS that's also on these networks).
  743.  
  744.          Our FidoNet address is 1:104/333.
  745.          Our RIME address is 1235 or RAMSISLE.
  746.          Our Internet address is 76244.324@compuserve.com.
  747.  
  748.       VOICE TELEPHONE
  749.  
  750.       You may reach us by voice telephone at 303-841-2848.
  751.  
  752.       MAIL
  753.  
  754.       You may contact us by mail at
  755.  
  756.          Rams' Island Software
  757.          7644 E. Lakecliff Way
  758.          Parker, Colorado 80134-5904
  759.          USA
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.    VendView Viewer v1.00             -10-                         July 1994
  767.  
  768.  
  769.  
  770.  
  771.    VendView User's Guide                                           VendView
  772.  
  773.  
  774.        
  775.                +----------------------------------------------+
  776.                | VendView: A User's Viewer for VENDINFO Files |
  777.                +----------------------------------------------+
  778.  
  779.       VendView is a simple menu-driven viewer allowing the end-user to see
  780.       relevant portions of the information in a VENDINFO.DIZ file. Its
  781.       operation is straightforward, but it can be used in two different
  782.       ways, and you need to understand the difference.
  783.  
  784.          o It can be invoked simply to view VENDINFO files.
  785.  
  786.          o It can be used to test package integrity, as well as to
  787.             view the VENDINFO file contained in a package.
  788.  
  789.  
  790.    Use of VendView Simply to View VENDINFO Files
  791.    ---------------------------------------------
  792.  
  793.       If you're not interested in testing the package contents for in-
  794.       tegrity, or you have only the VENDINFO file rather than the complete
  795.       package, then you can simply invoke VendView on the VENDINFO.DIZ
  796.       file. You can specify the desired file on the command line, so that:
  797.  
  798.          vendview VENDINFO.DIZ
  799.  
  800.       would load the VENDINFO.DIZ file. Alternatively, the simple command
  801.  
  802.          vendview
  803.  
  804.       will start the viewer and will automatically load VENDINFO.DIZ if it
  805.       is the only VENDINFO file in the directory.
  806.  
  807.       If you have not placed VENDVIEW.EXE in a directory that's on your DOS
  808.       path, you'll need to use the full pathname of that file, such as:
  809.  
  810.          c:\vendview\vendview.exe VENDINFO.DIZ
  811.  
  812.       If you're executing VendView from a read-only medium, such as a CD-
  813.       ROM drive, you'll have to use the -d (directory) command-line flag,
  814.       to assign a writeable directory in which VendView can create its
  815.       VENDVIEW.CFG configuration file. You might also need to do this if
  816.       you're using a version of MS-DOS earlier than 3.0. An example might
  817.       be:
  818.  
  819.          d:\files\vendview\vendview.exe -dc:\myconfig
  820.  
  821.       If you maintain a collection of VENDINFO files, you will need to
  822.       rename them to match their corresponding package names, in which case
  823.  
  824.  
  825.    VendView Viewer v1.00             -11-                         July 1994
  826.  
  827.  
  828.  
  829.  
  830.    VendView User's Guide                                           VendView
  831.  
  832.  
  833.       the directory may contain multiple VENDINFO files with names like
  834.       INCXT11.DIZ. To pre-load such a file, use the command
  835.  
  836.          vendview INCXT11.DIZ
  837.  
  838.       or you can simply load it manually after VendView is running, using
  839.       the File Load command.
  840.  
  841.       Once you've invoked VendView, it should be pretty clear what to do.
  842.       Every menu item includes help text, as does every field of informa-
  843.       tion when you're viewing VENDINFO.DIZ content. To see the help infor-
  844.       mation, just press function key F1. Pressing F1 twice will always
  845.       cause VendView to display the index of the help system, from which
  846.       you can select topics for review. Just place the cursor on the
  847.       desired item, and press ENTER.
  848.  
  849.  
  850.    Use of VendView to Test Package Integrity
  851.    -----------------------------------------
  852.  
  853.       To use VendView for this purpose, it is necessary to perform three
  854.       steps:
  855.  
  856.          o Unpack the distribution package of the product you're evaluating
  857.             into an empty directory.
  858.  
  859.          o Make sure that directory is the current working directory.
  860.  
  861.          o Invoke VENDVIEW.EXE.
  862.  
  863.       Let's consider each of these steps in turn.
  864.  
  865.       To unpack the distribution package appropriately, you should either
  866.       create a new directory or use an existing, empty directory. It is
  867.       important that the directory contain no files other than those from
  868.       the package, since the files in the directory will be compared with
  869.       those released by the author. If you've received the package in the
  870.       form of a compressed file (e.g., PACKAGE.ZIP), then a sequence like
  871.       this might be appropriate:
  872.  
  873.          c:
  874.          cd \
  875.          mkdir tempdir
  876.          cd tempdir
  877.          copy <place full path of source directory here>\PACKAGE.ZIP
  878.          pkunzip PACKAGE.ZIP
  879.          del PACKAGE.ZIP
  880.  
  881.       If you've received the package on a diskette that's in drive A, then
  882.  
  883.  
  884.    VendView Viewer v1.00             -12-                         July 1994
  885.  
  886.  
  887.  
  888.  
  889.    VendView User's Guide                                           VendView
  890.  
  891.  
  892.       the sequence might be:
  893.  
  894.          c:
  895.          cd \
  896.          mkdir tempdir
  897.          cd tempdir
  898.          copy A:\*.*/v
  899.  
  900.       Obviously, the exact procedure used here will depend on how you have
  901.       your system configured and what tools you have available. The above
  902.       examples are provided mainly to help you understand the intended
  903.       effect.
  904.  
  905.       The examples above have the side effect that the relevant directory
  906.       is the current working directory after the commands have been ex-
  907.       ecuted. If you use some other sequence or tool to unpack the package,
  908.       you may then need to do something like this:
  909.  
  910.          c:
  911.          cd \tempdir
  912.  
  913.       Finally, you need to invoke VENDVIEW.EXE, using the command:
  914.  
  915.          vendview
  916.  
  917.       if you have placed VENDVIEW.EXE in a directory that's on your DOS
  918.       PATH, or
  919.  
  920.          c:\tools\vendview
  921.  
  922.       if (as an example) it is located in C:\TOOLS, which is not on your
  923.       DOS PATH.
  924.  
  925.       This will start VendView, which will automatically load the
  926.       VENDINFO.DIZ file from the package, assuming it is a normal package
  927.       containing only VENDINFO.DIZ, perhaps FILE_ID.DIZ, and no other files
  928.       with filename extension "DIZ".
  929.  
  930.       You can now view the contents of the VENDINFO.DIZ file itself, and
  931.       the Test Package command will allow you to test package integrity, by
  932.       comparing the package's Packing List with the actual file contents of
  933.       the package. ated in C:\TOOLS, which is not on your DOS PATH.
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.    VendView Viewer v1.00             -13-                         July 1994
  944.